home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / pcp / lib / pmview-args.z / pmview-args
Text File  |  1997-04-03  |  6KB  |  248 lines
  1. #
  2. #  Copyright (c) 1994 Silicon Graphics, Inc.
  3. #  ALL RIGHTS RESERVED.
  4. # 
  5. #  U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND
  6. #  Use, duplication or disclosure by the Government is subject to
  7. #  restrictions as set forth in FAR 52.227.19(c)(2) or subparagraph
  8. #  (c)(1)(ii) of the Rights in Technical Data and Computer Software clause
  9. #  at DFARS 252.227-7013 and/or similar or successor clauses in the FAR,
  10. #  or the DOD or NASA FAR Supplement.  Contractor/manufacturer is Silicon
  11. #  Graphics, Inc., 2011 N. Shoreline Blvd., Mountain View, CA 94039-7311.
  12. # 
  13. #  THIS SOFTWARE CONTAINS CONFIDENTIAL AND PROPRIETARY INFORMATION OF
  14. #  SILICON GRAPHICS, INC.  ANY DUPLICATION, MODIFICATION, DISTRIBUTION, OR
  15. #  DISCLOSURE IS STRICTLY PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN
  16. #  PERMISSION OF SILICON GRAPHICS, INC.
  17. # /
  18.  
  19. #
  20. # $Id: pmview-args,v 2.3 1997/03/26 03:21:13 kenmcd Exp $
  21. #
  22.  
  23. prog=`basename $0`
  24.  
  25. #
  26. # Standard usage and command-line argument parsing for pmview front ends.
  27. # This file should be included by pmview front end scripts to present a
  28. # consistent interface. See pmview(1), dkvis(1), mpvis(1) and nfsvis(1)
  29. # for more information on their respective interfaces.
  30. #
  31.  
  32. #
  33. # The front end scripts should call _pmview_usage after their own usage 
  34. # information in a subroutine called _usage. The _usage subroutine may be 
  35. # called by either _pmview_usage or _pmview_args.
  36. #
  37.  
  38. _pmview_usage()
  39. {
  40.     echo '
  41.   -A align      align sample time to natural boundaries
  42.   -a archive    metrics source is an archive log
  43.   -C            check configuration file and exit
  44.   -h host       metrics source is PMCD on host
  45.   -n namespace  use an alternative PMNS
  46.   -O time       initial sample time origin
  47.   -p port       time control port
  48.   -S time       start sample time
  49.   -t interval   sample interval in seconds(float) [default 1.0]
  50.   -T time       terminate sample time
  51.   -z            set reporting timezone to local time for host from -a or -h
  52.   -Z timezone   set reporting timezone
  53.  
  54.   -display  display-string
  55.   -title    title-string
  56.   -geometry geometry-string
  57.   -name     name-string
  58.   -xrm resource [-xrm ..]'
  59. }
  60.  
  61. #
  62. # One of the first actions of a front end script should be to call 
  63. # _pmview_args. It sets the following variables:
  64. #
  65. # host        the host specified with -h.
  66. # arch        the first archive specified with -a (other archives are
  67. #               passed on to pmview).
  68. # args          The list of args that pmview will comprehend and use.
  69. # otherArgs     The arguments pmview will not understand and should be
  70. #               handled by the front end script.
  71. # titleArg    The title the user prefers. If empty, the title should be
  72. #               provided by the front end script.
  73. # prog        The name of the program.
  74. # namespace    The namespace (including the flag) if specified, else empty
  75. #               eg "-n foo"
  76. #
  77.  
  78. _pmview_args()
  79. {
  80.  
  81. host=""
  82. arch=""
  83. args=""
  84. otherArgs=""
  85. titleArg=""
  86. namespace=""
  87.  
  88. while [ $# -gt 0 ]
  89. do
  90.     case $1
  91.     in
  92.     -g*|-d*|-name|-xrm)
  93.         # assume an X11 argument
  94.         if [ $# -lt 2 ]
  95.         then
  96.         echo "$prog: $1 requires one argument"
  97.         _usage
  98.         exit 1
  99.         fi
  100.         args="$args $1 '$2'"
  101.         shift
  102.         ;;
  103.  
  104.     -title)
  105.         # assume an X11 argument
  106.         if [ $# -lt 2 ]
  107.         then
  108.         echo "$prog: $1 requires one argument"
  109.         _usage
  110.         exit 1
  111.         fi
  112.         titleArg="$2"
  113.         shift
  114.         ;;
  115.  
  116.     -A|-D|-O|-p|-S|-T|-t|-Z)
  117.         if [ $# -lt 2 ]
  118.         then
  119.         echo "$prog: $1 requires one argument"
  120.         _usage
  121.         exit 1
  122.         fi
  123.         args="$args $1 '$2'"
  124.         shift
  125.         ;;
  126.  
  127.     -A*|-D*|-O*|-p*|-S*|-T*|-t*|-Z*|-C|-z)
  128.         args="$args $1"
  129.         ;;
  130.  
  131.     -a)
  132.         if [ "X$host" != X ]
  133.         then
  134.         echo "$prog: only one of -h or -a maybe specified"
  135.         _usage
  136.         exit 1
  137.         fi
  138.         if [ $# -lt 2 ]
  139.         then
  140.         echo "$prog: $1 requires one argument"
  141.         _usage
  142.         exit 1
  143.         fi
  144.         if [ "X$arch" = X ]
  145.         then
  146.             arch=$2
  147.         fi
  148.         args="$args -a $2"
  149.         shift
  150.         ;;    
  151.  
  152.     -h)
  153.         if [ "X$arch" != X -o "X$host" != X ]
  154.         then
  155.         echo "$prog: only one of -h or -a maybe specified"
  156.         _usage
  157.         exit 1
  158.         fi
  159.         if [ $# -lt 2 ]
  160.         then
  161.         echo "$prog: $1 requires one argument"
  162.         _usage
  163.         exit 1
  164.         fi
  165.         host=$2
  166.         args="$args -h $2"
  167.         shift
  168.         ;;
  169.  
  170.     -n)
  171.         if [ $# -lt 2 ]
  172.         then
  173.         echo "$prog: $1 requires one argument"
  174.         _usage
  175.         exit 1
  176.         fi
  177.         namespace="-n $2"
  178.         args="$args -n $2"
  179.         shift
  180.         ;;
  181.  
  182.     *)
  183.         otherArgs="$otherArgs $1"
  184.         ;;
  185.  
  186.     esac
  187.     shift
  188. done
  189. }
  190.  
  191. # standard fatal error reporting
  192. # Usage: _pmview_error message goes in here
  193. #        _pmview_error -f file
  194. #
  195. _pmview_error()
  196. {
  197.     _pmview_note Error error $*
  198. }
  199.  
  200. # standard warning
  201. # Usage: _pmview_warning message goes in here
  202. #        _pmview_warning -f file
  203. #
  204. _pmview_warning()
  205. {
  206.     _pmview_note Warning warning $*
  207. }
  208.  
  209. # standard info
  210. # Usage: _pmview_info message goes in here
  211. #        _pmview_info -f file
  212. #
  213. _pmview_info()
  214. {
  215.     _pmview_note Info info $*
  216. }
  217.  
  218. # generic notifier
  219. # Usage: _pmview_note tag icon args ...
  220. #
  221. _pmview_note()
  222. {
  223.     tag=$1; shift
  224.     icon=$1; shift
  225.     button=""
  226.     [ $tag = Error ] && button="-B Quit"
  227.  
  228.     if [ -z "$DISPLAY" -o "${PCP_USE_STDERR+yes}" = yes ]
  229.     then
  230.     if [ $# -eq 2 -a "X$1" = X-f ]
  231.     then
  232.         echo "$prog: $tag: ..."
  233.         cat $2
  234.     else
  235.         echo "$prog: $tag: $*"
  236.     fi
  237.     else
  238.     if [ $# -eq 2 -a "X$1" = X-f ]
  239.     then
  240.         /usr/bin/X11/xconfirm -icon $icon -file $2 -useslider -header "$tag $prog" $button >/dev/null 2>&1
  241.     else
  242.         /usr/bin/X11/xconfirm -icon $icon -t "$*" -noframe -header "$tag $prog" $button >/dev/null 2>&1
  243.     fi
  244.     fi
  245.  
  246.     [ $tag = Error ] && exit 1
  247. }
  248.